home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / comm2 / offlnsft.lha / OfflineSafety / doc next >
Text File  |  1995-07-26  |  3KB  |  76 lines
  1. Offline Safety via DoHighReadMagic
  2. ----------------------------------
  3.  
  4. Introduction:
  5.  
  6. Offline message reading is handy, but problems occur. Making a message
  7. bundle may fail, or you may lose it before you have a chance to read
  8. any of the messages. When this happens, it would be a great thing if
  9. you could just push a switch and get the messages back. DoHighReadMagic
  10. does this magic for you!
  11.  
  12. You run DoHighReadMagic each time a bundling is about to take place, and
  13. make a backup of the user's message pointers. If a problem would occur,
  14. all the user would have to do, is issue a command that would then run
  15. DoHighReadMagic again, this time restoring the backup! Now, the user
  16. can try to bundle again.
  17.  
  18. Purpose:          To make a backup of a user's message pointers (also known
  19.                   as highread values), or restore it.
  20.  
  21. Template:         PATH/A,BKUP,LOAD/S,SAVE/S,VIEW/S
  22.  
  23. Format:           <User Path> [<Backup File>] LOAD|SAVE|VIEW
  24.  
  25. Operation:
  26.  
  27. DoHighReadMagic is passed the full path to the user's directory, and one of
  28. the options LOAD, SAVE and VIEW to determine the nature of the operation:
  29.  
  30.          LOAD     Restore the backup
  31.          SAVE     Make a backup
  32.          VIEW     List the user's highread values (for testing purposes)
  33.  
  34. By default, the backup will be made in a file called HighRead.backup, which
  35. will be placed in the user's directory. You may specify another name though.
  36.  
  37. Examples:
  38.  
  39. DoHighReadMagic BBS:User/20 VIEW
  40.  
  41. Will list you the highread values of user number 20.
  42.  
  43. DoHighReadMagic BBS:User/20 SAVE
  44.  
  45. Will save the highread values of user 20 into BBS:User/20/HighRead.backup.
  46.  
  47. DoHighReadMagic BBS:User/20 hr LOAD
  48.  
  49. Will load the highread values of user 20 from BBS:User/20/fr. The user path
  50. argument may be followed by a file name to be used. It will always be placed
  51. in the user's directory. Do *NOT* specify a full path name.
  52.  
  53. Technical details:
  54.  
  55. DoHighReadMagic opens and loads the User.dat file in the given directory,
  56. and prints the information (VIEW), opens a new backup file and writes the
  57. data (SAVE), or opens an old backup file and reads the data plus saves the
  58. user file (LOAD). The magic identification sequence "HRBK" (HighRead BacKup)
  59. will be written to the beginning of the backup file followed by the number
  60. of highread values stored in the backup file. If the number of areas in your
  61. message base changes, DoHighReadMagic will notify the user (if the output
  62. is redirected to TECHIO:, see Magic.dat) that there are a different amount
  63. of highread values in the backup than there are in the user file. This will
  64. not cause a problem though. If there are less highread values in the backup,
  65. they will all be restored, and the highread values of the (new) higher
  66. numbered areas will remain the same. If there are more, only as many will
  67. be restored as there are areas in the user file.
  68.  
  69. See also:
  70.  
  71. Magic.dat for TechnoBBS menu code to run DoHighReadMagic.
  72.  
  73.  
  74. The contents of this distribution are copyright 1995 by Sami Klemola.
  75.  
  76.